Content
在 AI 驱动的工作流中，Issue 是人类与 AI 协作的主要通信接口。一个高质量的 Issue，如同清晰的施工图纸，需要包含完整的背景、明确的可复现步骤、具体的预期行为以及已知的边界条件，AI 才能基于此独立行动。反之，一个模糊、缺乏上下文的 Issue 会让 AI 不断陷入“询问-等待”的循环，实质上阻塞了工作流。因此，Issue 的质量不只影响单次任务，更决定了团队在 AI 时代协同工作的整体效率瓶颈。
Acceptance
Question
- 你写 Linear issue 的时候，是否符合这个标准？Claude Code 能直接处理你的 issue 吗？
- Issue 质量本质上是不是一种「翻译能力」——把人类意图翻译成 AI 可执行的指令？
- askuser 频繁触发到底是 AI 的问题还是 Issue 的问题？
See Also
AI-Native 工程师
Spec-First Development
Reference
- 2026-03-20 AI-Native Hiring Guide 分析
YoYo’s Note
^5c42c9
在 AI 驱动的工作流中，Issue 是人类与 AI 的主要通信接口，其质量直接决定 AI 能走多远。
5 分 Issue（AI 可直接处理）
背景清晰 + 复现路径完整 + 预期行为明确 + 边界条件已列出
1 分 Issue（AI 无法行动）
「搜索有问题，请修复」——模糊、缺上下文、无约束
高阶能力
不只是写好 Issue，而是识别 Issue 模糊性的根本原因。如果 AI 频繁 askuser，问题不在 AI，在 Issue 写的人。
为什么重要
写模糊 Issue 的人不只影响自己——在团队流程中，一个差的 Issue 会触发一连串的 askuser → 等待 → 补充 → 重试，拖慢所有人。沟通效率是 AI 时代最大的瓶颈。